home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / bbsgif.zip / BBSGIF.DOC next >
Text File  |  1989-07-25  |  7KB  |  161 lines
  1. BBSGIF Quick Notes
  2. V 0.9h  28-July-89
  3. ------------------
  4.  
  5. This file contains brief documentation on BBSGIF, an online GIF image view/
  6. capture utility using the 1K-XModem CRC protocol.  This document assumes you
  7. are familiar with external protocol modules (such as DSZ.COM by Omen Tech.)
  8. in general, and the Graphics Interchange Format (GIF) as it relates to the
  9. storage of graphics images in files.
  10.  
  11. This is a BETA release of the program - all known bugs have been removed.
  12. If you find a bug, please report it to me at either of the addresses listed
  13. at the end of this document.
  14.  
  15. "GIF" and "Graphics Interchange Format" are service marks of CompuServe, Inc.,
  16. an H&R Block company.
  17.  
  18. -----
  19.  
  20. INSTALLING:
  21.  
  22. BBSGIF should be installed with the comm software you intend to use it
  23. with; i.e., in the same subdirectory.  Additionally, you should add one
  24. of the two the following lines to your AUTOEXEC.BAT file:
  25.  
  26. SET OZPORT=?
  27.   or
  28. SET DSZPORT=?
  29.  
  30. where the question mark is replaced with the number of the comm port to which
  31. your modem is connected.  If you also use the DSZ.COM external X/Y/ZModem
  32. protocol module by Omen Technology(tm), you should use the second of the two.
  33. If your modem is connected to an IBM PS/2 on COM 3 or 4, or if your serial
  34. port does not reside at the "standard" base address and/or interrupt request
  35. line for that number port, there are two other environment variables you
  36. need to set:
  37.  
  38. SET OZBASE=?
  39. SET OZIRQ=?
  40.  
  41. where the question mark in the OZBASE line is replaced with the _decimal_
  42. base address of your comm port hardware, and the question mark in the OZIRQ
  43. line is replaced with the number of the Int. Request line your port uses.
  44.  
  45. BBSGIF provides "Super" VGA support for several different types of cards.
  46. However, it cannot detect which type of SVGA card you have beyond that it
  47. supports standard VGA modes.  If a VGA card is detected, the software checks
  48. to see if it uses a Tseng Labs chipset and if not assumes "vanilla" VGA.  (The
  49. Tseng chipset is used on Orchid, STB, Genoa and other popular SVGA cards.)
  50. Most GIF images available on CIS and the BBS's that were produced on IBM-type
  51. hardware have sizes that match one of the modes available on this chipset.
  52. Other popular chipsets are manufactured by Paradise, Video7, Chips&Tech. and
  53. Trident.  These other chipset manufacturers' modes may or may not match up
  54. well to these Tseng mode sizes.  The only SVGA mode that all of them share is
  55. a 640x480x256 mode.  BBSGIF allows you to tell it which of these other chipset
  56. types your card uses, and then forces all images over 320x200 to use this
  57. 640x480 mode.  This means that 640x350 images may appear somewhat "squashed"
  58. on these other card types, but allows all images to display normally.  (Those
  59. with Tseng Labs chipsets will still have full autodetection in 640x350, 800x600
  60. and 1024x768 modes.)  To tell BBSGIF which of these special card types you use,
  61. add the following line to your AUTOEXEC.BAT file:
  62.  
  63. SET OZVID=?
  64.  
  65. where the question mark is replaced with:
  66.  
  67. P  - for Paradise chipset cards
  68. V  - for Video7 chipset cards
  69. T  - for Trident chipset cards
  70. C  - for Chips&Technologies chipset cards (both 435 and 441 versions)
  71.  
  72. ----
  73.  
  74. If you prefer passing such information on the command line rather than as
  75. environment variables, BBSGIF allows it.  The following command line
  76. switches can be used:
  77.  
  78. -C<port#>
  79. -B<baudrate>
  80. -A<baseaddr>
  81. -I<irq>
  82. -V<cardtype>
  83.  
  84. BBSGIF forces N/8/1 parameters because they are required for the protocol
  85. transfer.  The default port is #1 so if your modem is attached to that port
  86. you need _no_ command line parameters or environment variables (other than
  87. the filename command line parameter and possible chipset identifier - see
  88. below.)
  89.  
  90.  
  91. RUNNING:
  92.  
  93. BBSGIF is best used when installed as an external protocol module directly
  94. in your regular comm software (if it supports such setups.)  For programs
  95. like ProComm Plus and Boyan, this means directly into the configuration
  96. section of the program.  Programs like QModem require you to write a batch
  97. file to handle parameters passing, etc.  Follow your comm software's
  98. instructions concerning this type of setup.  If your commware only supports
  99. a generic "shell to DOS" capability, you may want to create a batch file to
  100. ease parameters passing.  You _must_ pass to BBSGIF a filename for the cap-
  101. tured image file on the command line, just like you do most other ext. proto
  102. modules.
  103.  
  104. BBSGIF is used in exactly the same way as most other protocol modules.  You
  105. simply request a 1K-XModem download of the GIF image file, then invoke BBSGIF
  106. at the same time and in the same manner you would DSZ or other external proto
  107. module.  BBSGIF does the rest.  You must provide a filename for the captured
  108. image on the command line.  You can abort the protocol transfer at any time;
  109. just press [ESC].  All other keys are ignored.  When the image transfer is
  110. complete, the program will beep and the image will be left displayed.  Press
  111. [Enter] to exit BBSGIF and return to your communications program.  If too many
  112. protocol errors occur, or the sending program decides to cancel the transfer,
  113. the image will be aborted and the partial capture file deleted.  Remember that
  114. if you sit and look at the image for very long after it has been "painted" on
  115. the screen and the beep signaling end-of-transfer has sounded, any prompt that
  116. may be issued by the BBS software following any normal download will be lost.
  117.  
  118. BBSGIF currently _only_ supports 1K-XModem CRC as the protocol used in
  119. handling the GIF image stream.  Be sure to tell the BBS software to use
  120. 1K-XModem (_not_ YModem) to send the file.  Other protocols (especially
  121. 1K-XModem "G" for link-level error-corrected lines) will be implemented in
  122. later versions, as will support for other SVGA adapters/modes.
  123.  
  124.  
  125. REVISION HISTORY:
  126.  
  127. 0.9c - original "raw" release
  128.  
  129. 0.9f - added John Bridges' exellent bankswitching code to implement card types
  130.        besides Tseng.  Updated mode selection code to work with other card's
  131.        640x480x256 modes.  Corrected bug causing connection to be broken at
  132.        end of transfer.  Corrected bug causing image capture file to not be
  133.        saved properly.
  134.  
  135. 0.9h - first BETA release.  Fixed a new capture bug.  Added alarm sounds when
  136.        the image capture is aborted in the middle of an image due to disk
  137.        error (the image will continue to display.)  Cleaned up a few rough
  138.        spots.  Added default extension (.GIF) forcing.
  139.  
  140.  
  141.  
  142. KUDOS:
  143.  
  144. Chris Young for his major help with the LZW decompress routines and EGA video
  145. code.
  146.  
  147. John Bridges for the SVGA bankswitching code and modes-selection code for
  148. Paradise/Video7/Trident/C&T chipsets.
  149.  
  150. Tim Wegner, Bert Tyler et al for some video code from their FRACTINT program.
  151.  
  152.  
  153.  
  154. Steve Sneed
  155. 409 San Juanico
  156. Santa Maria, CA.  93455
  157.  
  158. CIS ID 71520,77 or 70007,3574
  159. or
  160. The GRAFX Group/Minds in Motion BBS   1-714-240-7459
  161.